Rockwell Automation Application Content 
Device Libraries 


Reference Manual 
Power Discrete — Device Object Library 


raC_Dvc_E300 V10.0 


Device Object Libraries 


Important User Information 


Solid-state equipment has operational characteristics differing from those of electromechanical equipment. Safety 
Guidelines for the Application, Installation and Maintenance of Solid-State Controls (publication SGI-1.1 available 
from your local Rockwell Automation sales office or online at http://literature.rockwellautomation.com) describes 
some important differences between solid-state equipment and hard-wired electromechanical devices. Because of 
this difference, and because of the wide variety of uses for solid-state equipment, all persons responsible for 
applying this equipment must satisfy themselves that each intended application of this equipment is acceptable. 


In no event will Rockwell Automation, Inc. be responsible or liable for indirect or consequential damages resulting 
from the use or application of thisequipment. 


The examples and diagrams in this manual are included solely for illustrative purposes. Because of the many 
variables and requirements associated with any installation, Rockwell Automation, Inc. cannot assume responsibility or 
liability for actual use based on the examples and diagrams. 


No patent liability is assumed by Rockwell Automation, Inc. with respect to use of information, circuits, equipment, 
or software described in thismanual. 


Reproduction of the contents of this manual, in whole or in part, without written permission of Rockwell Automation, 
Inc., is prohibited. 


Throughout this manual, when necessary, we use notes to make you aware of safety considerations. 


=o 
ZN 


Identifies information about practices or circumstances that can cause an explosion in a 
hazardous environment, which may lead to personal injury or death, property damage, or 
economic loss. 


Identifies information that is critical for successful application and understanding of the 
product. 


IMPORTANT 
Identifies information about practices or circumstances or death, property damage, or 
economic loss. Attentions avoid a hazard and recognize the consequence. 
ATTENTION 


_A 


SHOCK HAZARD 


AN 


Labels may be on or inside the equipment, that dangerous voltage may be present. 


Labels may be on or inside the equipment, for example, a drive or motor, to alert people 


that surfaces may reach dangerous temperatures. 
BURN HAZARD 
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1. Overview 


This document includes the functional requirements of the E300 Power Discrete Device Object. 


This Preconfigured Power Discrete Device Object includes an Add-On Instruction Rung and an HMI Faceplate 
providing: 


e Detailed Device Data Collection and Delivery 
e Enhanced Device Status and Diagnostics 
e Common Control Interfaces maximizing Flexible Automation Device Selection & Application Code Reuse 


Device Object Use Cases: 


e Basic Device Maintenance and Diagnostics 
e Virtual Device Operations for Startup and Commissioning 
e Operator and Program Control for Discrete Machine and Process Applications 


1.1 Prerequisites 


1.1.1 Required Software 
The E300 faceplates were developed using the following software packages: 


e Studio5000 Logix Designer v33.00.00 and later for PAC Application Development 
e Studio5000 View Designer v4.01 and later for PanelView 5000 Application Development 
e FactoryTalk View Studio v10 and later for PanelView Plus Application Development 


You will therefore need this version or newer for testing these faceplates. A VMware environment is 
acceptable for this testing. 


1.1.2 Required Hardware 
At minimum, you will need the following hardware to test these faceplates: 


e =PanelView 5500 with V4 or later firmware 
e ControlLogix 5580 and 5069 controllers with V33.011 or later firmware 
e E800 demo unit with V5.117 or later firmware 


1.2 Functional Description 
E300 Preconfigured Device Objects: 


e Collect, Process, and Deliver Data between Smart Devices and Application Logic 

e Provide Device Status & Diagnostics Faceplates for Machine Startup, Commissioning, Operations, and 
Maintenance 

e Include Common HMI Faceplate Components, Device States, and Control Interfaces providing Application 
Development and Operation Efficiency 
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All these features deliver the user a tool that provides quick feedback, shortens recovery time, and simplifies 
implementation. 


Device Object 


Mode Select 
Physicalized/Virtualized 


1.3 Footprint 


Characteristic 
Definition 


Instance 


Execution L8x 


Induction 
otor 


Description Value Unit 
Estimated memory required to store the object definition, 47.57 kB 

including all dependents (including 1 Instance). 

Estimated memory required per object instantiated. 2.3 kB 

Estimated execution time / scan footprint evaluated in 1756-L7x 60 us 

PAC 
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2. Device Object Architecture 


2.1 Functional Requirements 
2.1.1. Primary functions 


Physical Device Operation 
The following functions are applied when device object is selected as physical. 


Activate: Activate the device power structure. Device will follow the direction from control 
interface. 


Deactivate: Deactivate the device power structure by issuing Stop command. Reset active 
status. 


Jog: This function is possible from HMI faceplate only. When Jog command is 1, Activate device 
power structure. Once the command is 0, deactivate the device power structure by issuing stop 
command. Individual Jog forward and Jog reverse command are used to jog in either direction. 
Unlike other command bits, this command should not be unlatched by the device object. 


Fault Reset: Command to fault reset the device and reset status bits in device object. Command 
can be initiated from control interface and HMI interface. 


Virtual Device Operation 


Activate: Set status to reflect successful activate command, Device related signals like Logic 
command and Out Reference should not be altered. 


Deactivate: Reset the active status. 


Jog: This function is possible from HMI faceplate only. When Jog command is 1, set status to 
reflect successful jog command. Once the command is 0, reset the active status. Individual Jog 
forward and Jog reverse command are used to jog in either direction. Update the direction status 
based on jog forward and jog reverse. 


Fault Reset: Command to reset status bits in device object. Command can be initiated from 
control interface and HMI interface. 


2.1.2. Secondary functions 


FirstWarning: This function helps in capturing the first warning triggered in the device. Display 
the respective description in faceplate. 


FirstFault: Capture the first fault from device. Display the respective description in faceplate. 


Event log: Log Warning and Fault the last 4 events in a log queue. The queue contains fault 
code, description, and time stamp. Display the same in faceplate. 


Status Interface: Display device status 
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3. 


Data Types 


The following Power Discrete Common Control Interface tags are the primary device program tags to read 
and write to when interfacing to power discrete devices. The value of using these tags in your specific 
application code is that you may use a number of different power discrete devices such as ArmorStart 
Starters, E300 Overload Relays, or SMC-50 Smart Motor Controllers without having to update your 
application device interface tags. 


Note: 


For further information and examples on how to interface the power device objects with your specific 
application code refer to the “How_To_Interface_with_Power_Device_Logix.mp4’” video within the General 
Documents folder of the Power Device Library Download files. 


The Power Device Library may be downloaded from the Product Compatibility and Download Center. 
Search for Power Device Library. 
https ://compatibility.rockwellautomation.com/Pages/home.aspx 


3.1 RAC_ITF_DVC_PWRDISCRETE_SET 
This is the Power Discrete Common Control Interface User-Defined Data Type for device settings. Its 
members provide application program access to allow or inhibit commands and settings from the device 
faceplate or other external sources. The table below shows member names, descriptions, and tag data 
types. 
For example, to inhibit write commands from the device faceplate or other external sources write a 1 to the 
ModuleName_AOI\_CtlrSet.InhibitCmd program tag from your application program. This would prevent a 
jog command from the device faceplate. 
Member Description DataType 
InhibitCmd 1 = Inhibit user Commands from external sources; 0 = Allow Control BOOL 
InhibitSet 1 = Inhibit user Settings from external sources; 0 = Allow BOOL 
3.2 RAC_ITF_DVC_PWRDISCRETE_CMD 


This is the Power Discrete Common Control Interface User-Defined Data Type for device commands. Its 
members provide application program access to common device commands. 


Only write to these common command members to control the device. If you write directly to the device’s 
output command tags directly unexpected device operation could occur. 

For example, to start or activate the device write a 1 to the ModuleName_AOI|_CtIrCmd.Activate tag. Do 
not write to the ModuleName:O.RunForward tag. Although, you can write to the uncommon command tags 
in the device’s output tag if a specific common control interface tag does not exist. 


The table below shows member names, descriptions, and tag data types. 
All the commands are available whether operating the device physically or virtually. Virtual Operation 
allows you to test your application code without activating the device’s physical outputs. 
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This is the power device interfacing tag. By configuring these tags, we can read various status from the 
device like Ready, Connected, and Available etc. The below table shows detailed information of members 


used in this UDT tags. 


Member Description DataType 
bCmd Device Interface — Power Discrete Commands INT 
Physical 1 = Operate as a physical device BOOL 
Virtual 1 = Operate as a virtual device BOOL 
ResetWarn 1 = Reset Warning Status. Clears FirstWarning Capture Status BOOL 
ResetFault 1 = Reset Fault Status. Clears FirstFault Capture status. BOOL 
Activate 1 = Activate Output Power Structure. Commands the device to Run BOOL 
Deactivate 1 = DeActivate Output Power Structure. Commands the device to Stop | BOOL 
CmdDir Commanded Direction; 0=Forward, 1=Reverse BOOL 
Jog Jog Command BOOL 
Fast Fast speed of a 2-speed device BOOL 
Slow Slow speed of a 2-speed device BOOL 
3.3 RAC_ITF_DVC_PWRDISCRETE_STS 


Input Description DataType 
eState In this tag include enumerated state values. DINT 
1=Initializing 


2=Disconnected 
3=Disconnecting 
4=Connecting 
5=Idle, 
6=Configuring 
7=Available 


FirstWarning 


Capture the First Alarm Bit to trigger. Display the respective 
Description and Time Stamp on Faceplate. Log the same in Event 
Queue. 


Rac_UDT_Event 


FirstFault Capture the Fault Code of the device. Display the respective code, Rac_UDT_ Event 
description and timestamp on faceplate. Log the same in Event 
Queue. 
eCmdFail Enumerated command failure code DINT 
0 = Interface Initialization failure code 
1 = Operate as Physical Device failure code. 
2 = Operate as Virtual Device failure code 
bSts Status (Bit Overlays) INT 
Physical 1 = Operating as a physical device BOOL 
Virtual 1 = Operating as a virtual device BOOL 
Connected 1 = Showing Device connection status connected BOOL 
Available 1 = Device Available BOOL 
Warning If any warning alarm is activated, then this bit is set to 1 BOOL 
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Input Description DataType 
Faulted If any Fault is activated, then this bit is set to 1 BOOL 
Ready 1 = Device is active (Power Structure Active) BOOL 
Active 1 = Device is active (Power Structure Active) BOOL 
CmdDir Command direction; 1=Reverse, 0=Forward BOOL 
ActDir Actual direction; 1=Reverse, 0=Forward BOOL 
Cmdspd 1 = Motor is Commanded to run fast, 0 = slow BOOL 
Fast Fast speed selected (2-Speed device) BOOL 
Slow Slow speed selected (2-Speed device) BOOL 


3.4 RAC_EVENT 


An array of size 4 is to be used to log the FirstWarning and FirstFault capture. The data should be FIFO 
order. The same should be displayed on the Faceplate. 


Member Description DataType 
Type 1 = Status DINT 

2 = Warning 

3 = Fault 

4... = User 
ID User definable event ID DINT 
Category User definable category (Electrical, Mechanical, Materials, Utility, DINT 

etc.) 
Action User definable event action code DINT 
Value User definable event value or fault code DINT 
Message Event message text STRING 
EventTime_L Timestamp LINT 
EventTime_D Timestamp (Y,M,D,h,m,s,us) DINT[7] 


3.5 RAC_CODE_DESCRIPTION 


Member Description DataType 
Code Stores the value of device fault code. DINT 
Desc Stores the Messages related to fault code. STRING 
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3.6 


State Model 


The following section will discuss the state model for Device Object. The figure below shows the core 
logic states. 


By default, each state is active for a minimum of 256us to allow for evaluation of state outside of the ADO 
instance in the user program. 


Connected 


Available 


Configure 


Idle Configuring 


entry / 
do/ 
exit / 


Configure 


entry / 
do / 
exit / 


Disconnect 


Connecting Disconnecting 


entry / 
do/ 
exit / 


entry / 
do/ 
exit / 


Disconnected 


entry / 
do / 
exit / 


Initialize 


entry / 
do/ 
exit / 
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3.6.1 State Definitions 
State Enumeration | Type State Command 
Initializing 1 Acting ( Initial ) 
Disconnected 2 Wait 
Disconnecting 3 Acting Disconnect 
Connecting 4 Acting Connect 
Idle 5 Wait 
Configuring 6 Acting Configure 
Available 7 Dual 


3.6.2 State Actions 


State Action / Function 
Initialize object and interface (status, command, 
are etc.) data structures 
Initializing 


Set ADO to operate as Physical 
Device specific initialization if required 


Disconnected 


=> Connect 


Disconnecting 


Physical - Verify module connection to PAC 


wonneetng Virtual — N/A 
Idle > Configure 
on Verify all module configuration has been 
Configuring complete. 
Available Device specific 
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4.1 


User Interface 


The faceplate files allow you to quickly load, configure and use preconfigured status and diagnostic 
displays available for View Designer, Factory Talk View ME Edition and Factory Talk View SE Edition. 


In this document, the faceplate pictures (or snapshots) are of View Designer and is similar to Factory Talk 
View ME and SE Edition, and can be downloaded from Device Object Library available in Product 
Compatibility and Download Center. Search for Power Device Library. 


https://compatibility.rockwellautomation.com/Pages/home.aspx 


Note: 

For further information on faceplate configuration and operation refer to the 
“How_To_Import_and_Configure_E300_ Object” and Operational_Overview_of_E300_ Faceplates” videos 
within the E300 folder of the Power Device Library Download files. 


The Power Device Library may be downloaded from the Product Compatibility and Download Center. 
Search for Power Device Library. 
https ://compatibility.rockwellautomation.com/Pages/home.aspx 


Faceplate Navigation 


Faceplate Title Close / Return 


Cy me Ready 
frewre}— |B 
[reutteo} 1 ia 


FLA TRIP 


Off 


Currert Thermal Capacty Used 


Tab descriptions: 


The Home tab provides a device status summary and basic control functions 
The I/O or Input/output tab displays the on/off status of the device’s I/O 
The Trend tab displays real-time values of position and velocity for the device in user units 


The Fault tab displays a running history of the last (4) faults and alarms with descriptions 
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4.2 Common Status 


A banner will be displayed at the top of each screen to provide the following information of the device: 
1. Ready or Not Ready 
2. Faulted (device will show Not Ready and fault message). 
3. Virtualized 
4 


Communications loss. 


Banner eg. in 
-——am Read 
bf —— Ready State 


If device not ready and 
not faulted then 

"Drive Not Connected / 
Drive Not Available/ 
Faulted " will display 


Banner eg. in 
Not Ready OverVoltage Not Ready State 


If Vitual mode, 


Fault Message for ||then “Virtual” will 
latest fault present| [Set display 


Green (Ready) 
Yellow (Not ready) 


Yellow Border & 
Black Background 
for Fault present 


13 


Device Object Libraries 


4.3 Home Screen 


The Home screen is visible when the Home tab button is selected in the tab control object on the left 
side of the screen. 


The Home screen is the main screen for the faceplate. It contains a gauge object, two small trends 
called sparklines and a jog control object. These objects are created with sets of elements grouped 
into 3 sub-groups: grp_Data, grp_Dir, grp_Jog. 


On the top left is a speed indicator that is a multi-state indicator and changes text based on the device 
state. Other text for state changes include, “Forward”, “Reverse”, “Zero Speed”, and “Off”. The 
Current, %FLA and %TCU are large blue numeric display that are read-only. Below the numeric 
display is a Spark line to display %FLA. And another spark line is to display %TCU. 


Drive Action 
Forward / Reverse / Off 


E300 Electronic Overload Relay 


Navigation 
Tabs 
Thermal Capacty Used 


0.0 %7 


Actual Current Actual TCU 
on spark on spark 
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2Ungroup Wh Order ~ JA Flip ~ 


> grp_Data 
> grp_Jog 
> grp_Dir 


Wallpaper 


E300 Electronic Overload Relay 


grp_Revision 
tab_IO_001 
tab_Fit 
tab_Trnd 

>  grp_CurTrnd 
> grp_TCUTrnd 
> grp_Banner 


Banner 


btn_Revision 
rev_Ind 
TabCtrl 


4.4 1/0 Screen 


The I/O tab displays the on/off status of the device’s I/O. LED shows no color when they are in the 
OFF position and shows blue when they are in the ON position. 


The IO screen displays contain multiple Status indicator LED’s for Input and Output. This screen has 
many sub groups. 
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@ Order ~ dA Flip ~ 4 raC_Dvc_E300_FP 


> Banner 


4a 
> grp_Pt0_001 

Qeneees teeeces es cpenees cle cecuscscesasus cis teasers dasegescsesceses cls cecosuscseusnucistsececs escaeesuseeccse > grp_Pt1_001 

: grp_Pt2_001 

> grp_Pt3_001 
grp_Pt4_001 

> grp_Pt5_001 
txt_Cap_Input_001 


txt_Cap_Output 
> Grp_Outl 
Grp_Out2 
> Grp_Outd 
Wallpaper 
> tab_Home 
> tab_Trnd 


> tab_Fit 


> grp_Revision 


4.5 Trend Screen 


Trends display values over time, often used to compare similar or related values and to allow 
operators to predict future states to make control action decisions. 


— Thermal Capacity Used 12% 


CR ET 


The trend screen displays two trends for current (FLA%) and Thermal capacity used. It contains 
numeric displays for these two values, labels, and engineering units. These objects are grouped into 
3 sub-groups: grp_Banner, grp_CurTrnd and grp_TCUTrnd. 
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tab_Trnd 


> grp_CurTrnd 


> grp_TCUTrnd 
> grp_Banner 


Wallpaper 


> grp_Revision 
— Current ###t.# %FLA 
100 > tab_Fit 
w = Banner 
btn_Revision 
05 ; — 5 
wo — 


aq ihermal Capacity Used. # % Tan 


04 
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4.6 


4.6.1 


Fault Warning Screen 


The Fault Warning screen displays information for up to four faults for the device. The fault table 
displays the Severity level (Fault, Warning or Active Fault), time (and date) and a description of the 


fault. 


Note, only row 1 will display the “Active Fault” in the severity column if there is a current active fault, 
else it will display the last fault. Rows 2-4 only display past faults and warnings, not an active fault. 


E300 Electronic Overload Relay 


2 current Loss 


Severity Time 


Active 1998-01-03 =Phase current Loss in one of the 
Fault 2:37:04 metor phases 


1998-01-02 
8:58:44 
2018-12-05 = Phase current Loss in one of the motor 

10:55:38 phas es 


2018-11-28 = Phase current Loss in one of the motor 
20:40:33 phases 


Yellow Border 


if Active Fault Module Mismatch Trip 


Fault 


Fault 


Fault Event Time 
Fault Severity 


Most recent 4 
Faults Event Messages 


Details Screen 


Latest fault is in first 
row and if it is active 
then text will be in bold 


The Details Screen provides a more detailed description and possible action steps to remedy 


condition. 


E300 Electronic Overload Relay > 4 


Not Reacty Phase current Loss 


Details x 


1998-01-03 2:38:25 
Description/Action 
Phase current Loss in one of the motor phases 


1. Check for open line (i.e. blown fuse). 

2. Check power terminations 

3. Inspect contactor for proper operation. 

4. Single-phase apps require Par176 set to single phase. 
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5. Appendix 


For More Configuration and Operational Information 


Refer to How to & Operational Videos within the PowerDeviceObjects folder of the Power Device 
Library download files. 


The Power Device Library may be downloaded from the Product Compatibility and Download Center. 
Search for Power Device Library. 


https://compatibility.rockwellautomation.com/Pages/home.aspx 


To Provide Feedback or Obtain Additional Information 


Contact RASimplification Team at rasimplification@ra.rockwell.com 


Disclaimer of Warranty 


THE MATERIALS PROVIDED OR REFERENCED BY WAY OF THIS DOCUMENT ARE PROVIDED "AS IS" 
WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, 
ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON- 
INFRINGEMENT OR OTHER VIOLATION OF RIGHTS. ROCKWELL AUTOMATION DOES NOT WARRANT OR 
MAKE ANY REPRESENTATIONS REGARDING THE USE, VALIDITY, ACCURACY, OR RELIABILITY OF, OR THE 
RESULTS OF ANY USE OF, OR OTHERWISE RESPECTING, THE MATERIALS PROVIDED OR REFERENCED BY 
WAY OF THIS DOCUMENT OR ANY WEB SITE LINKED TO THIS DOCUMENT 


Limitation of Liability 


UNDER NO CIRCUMSTANCE (INCLUDING NEGLIGENCE AND TO THE FULLEST EXTEND PERMITTED BY 
APPLICABLE LAW) WILL ROCKWELL AUTOMATION BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, 
INCIDENTAL, PUNITIVE OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION, BUSINESS 
INTERRUPTION, DELAYS, LOSS OF DATA OR PROFIT) ARISING OUT OF THE USE OR THE INABILITY TO USE 
THE MATERIALS PROVIDED OR REFERENCED BY WAY OF THIS DOCUMENT EVEN IF ROCKWELL 
AUTOMATION HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IF USE OF SUCH MATERIALS 
RESULTS IN THE NEED FOR SERVICING, REPAIR OR CORRECTION OF USER EQUIPMENT OR DATA, USER 
ASSUMES ANY COSTS ASSOCIATED THEREWITH. 
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